Overview

Date: February 16, 2026

Status: Ready to Implement

🥳 Welcome to Athos Commerce

The next generation of commerce discovery has arrived. The transition from Searchspring to Athos Commerce represents a ground-up modernization of our API architecture. We’ve consolidated legacy search, suggest, and personalization endpoints into a streamlined, high-performance global network.

This migration guide is specifically crafted for current Searchspring users looking to transition to the Athos framework. We will walk you through the 1-to-1 changes between versions, ensuring a seamless handoff for your search results, autocomplete, and product recommendations.

🚧
New to Athos? If you aren't a previous Searchspring client and are starting a fresh integration, you can skip this migration guide and head straight to our Athos V1 API Documentation.

📋 Summary and Roadmap

Athos Commerce is a unified platform designed to handle the high-load demands of modern e-commerce while providing deeper variant-level insights.

Our Commitment to You

While Athos Commerce is our primary path forward, we understand that stability is your top priority. We are committed to supporting Searchspring's legacy infrastructure indefinitely. You can migrate on the timeline that best fits your development cycle, though we encourage the move to unlock our latest innovation suite.

Phase 1:The New Standard

For all new clients and internal builds, the Athos v1 endpoints are now the standard for implementation.

Phase 2: Continued Legacy Support

We will continue to provide full uptime support and critical patches for legacy Searchspring endpoints to ensure your existing storefront remains stable.

Phase 3: The Innovation Gap

While legacy endpoints remain active, all new feature development is now exclusive to the Athos v1 architecture.

Phase 4: Encouraged Migration

We recommend that all existing clients plan a migration window to Athos Commerce to take advantage of the increased performance and new "Variant-First" data structures.

🌎 Global Changes

Beyond individual URL updates, Athos Commerce introduces fundamental shifts in how our infrastructure communicates with your storefront.

⚡ New Base URLs

The endpoint structure has been modernized to include explicit versioning (v1) and consistent routing. This ensures your integration remains stable and forward-compatible.

Searchspring (legacy): https://{siteId}.a.searchspring.io/api/...
Athos (modern): https://{siteId}.a.athoscommerce.net/v1/[module]

📘
Personaliztion Note All recommendation and bundling requests now route through our specialized personalization cluster at a.p13n.athoscommerce.net.

📦 The "Variant-First" Response

To maximize front-end flexibility and reduce layout shift, every search, autocomplete, and personalization endpoint now includes a native variants object in the JSON response. This allows you to display variant attributes directly from the initial API call.

🛠️ Migration at a Glance

While Athos Commerce provides a more powerful and intuitive search engine, it does introduce a few structural changes to ensure better performance and deeper product insights.

Key changes include:

New URL Structure: Moving to a versioned v1 base path on the athoscommerce.net domain.
Variant-First Response: All search and autocomplete responses now include a native variants object for granular product data.

Ready to Migrate?

Now that you understand the architectural shifts and our commitment to support, the next step is mapping your existing Searchspring endpoints to the new Athos v1 structure.

View the 1-to-1 Endpoint Migration Guide →